---
title: TagManager 标签管理器
icon: Tags
relatedFile: app/src/core/stage/stageManager/concreteMethods/StageTagManager.tsx
---

标签管理服务

该服务负责管理项目中各种舞台对象（如文本节点、区域、图片、连接线等）的标签。它提供了一系列功能，用于操作标签、为用户界面提供标签信息以及导航到带有标签的对象。

## API

### `changeTagBySelected()`

此方法用于为当前选中的舞台对象添加或移除标签。如果对象已经有标签，则移除；如果没有，则添加。目前主要支持文本节点。

### `refreshTagNamesUI()`

此方法用于获取所有标签的名称、唯一标识符（UUID）和颜色信息，以便在用户界面上进行渲染。它会根据不同类型的舞台对象（如文本、区域、图片、连接线等）提取相应的显示信息。

### `moveCameraToTag(tagUUID: string)`

此方法根据给定的标签唯一标识符（UUID）将摄像机移动到对应的舞台对象位置。如果标签对象是可连接实体，它还会计算相关联的子节点区域并调整摄像机视角，并添加视觉效果以突出显示。
